home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / miscellaneous / help / dos / dosman / man / edit < prev    next >
Encoding:
Text File  |  1996-09-07  |  3.7 KB  |  117 lines
  1.  
  2.  
  3.         EDIT (1.3, 2.x, 3.x) (Located in the C: Directory)
  4.  
  5.     SYNOPSIS
  6.         An AmigaDOS line editor.
  7.  
  8.     FORMAT
  9.             EDIT [FROM] fromname [TO] toname [WITH] withname 
  10.         [VER] vername [OPT W chars or WIDTH chars] [OPT P lines 
  11.         or PREVIOUS lines]
  12.  
  13.  
  14.  
  15.     EXPLANATION 
  16.  
  17.             Unless you grew up with UNIX and really dig line 
  18.         editors you should really try a different program (even 
  19.         Ed) before you dive into Edit. 
  20.  
  21.  
  22.             What does set Edit apart from Ed (and most other text 
  23.         editors) is that it is able to edit binary files and it 
  24.         can execute a predefined list of line editor commands.
  25.  
  26.             Please note that starting with version 2 of Ed you 
  27.         can do the same thing, so there is really no need to keep 
  28.         both of these programs hanging around on your system 
  29.         disk.
  30.  
  31.     
  32.     KEYWORDS
  33.  
  34.         FROM
  35.             EDIT requires the FROM keyword. This will tell EDIT 
  36.         which file to edit. This filename must exist. EDIT will 
  37.         not create the file for you like Ed will.
  38.  
  39.         TO
  40.             This will tell edit where to save the file to once 
  41.         you decide to finish. If this is the second command in 
  42.         your arguement, you do not need the TO keyword.
  43.     
  44.             EDIT is limited in the fact that it will not 
  45.         overwrite a file that already exists. If the TO filename 
  46.         is the same as the FROM filename then instead of 
  47.         overwriting the FROM filename it will be save the 
  48.         original as :t/edit.backup. The file you are working on 
  49.         then gets named and saved as the FROM filename.
  50.  
  51.         WITH
  52.             This specifies a file which will be used as input to 
  53.         EDIT's command options. The contents of WITH must be a 
  54.         series of valid options for it to work.  If WITH is the 
  55.         third argument in an EDIT command line, the keyword is 
  56.         optional. If you don't use this keyword you must manually 
  57.         input your parameters.
  58.  
  59.             Due to the huge scope of available commands you 
  60.         should consult your Amiga System manual on how to 
  61.         configure EDIT. 
  62.  
  63.             If there is enough of an interest I will write a full 
  64.         tutorial on how to configure EDIT.
  65.  
  66.         VER
  67.             This lets you specify where to send the output of 
  68.         EDIT to. You can send the output to any logical device 
  69.         including PRT: to print it.
  70.  
  71.         OPT W  or WIDTH
  72.         OPT P  or PREVIOUS
  73.             This lets you set the actual physical size of EDIT. 
  74.         WIDTH lets you set the actual line length.  PREVIOUS lets 
  75.         you designate how many lines will be kept in EDIT's 
  76.         history buffer. 
  77.  
  78.             The default for line length is 120 characters and the 
  79.         default history buffer is 40 lines. If you multiply the 
  80.         WIDTH by the PREVIOUS you will get the exact amount of 
  81.         RAM you need to reserve as a work buffer. This amount can 
  82.         be set with the STACK command. 
  83.  
  84.             If you set the OPT W and OPT P options, you must use 
  85.         the OPT keyword with the W or P letters.
  86.  
  87.  
  88.  
  89.     EXAMPLES
  90.  
  91.             1. To edit a file called MyText in the default 
  92.         directory:
  93.  
  94.         EDIT MyText
  95.  
  96.             2. To edit a file called MyText and to save it under 
  97.         a file called YourText that is 5000 lines long:
  98.  
  99.         EDIT FROM MyText TO YourText OPT P5000
  100.  
  101.             3. To edit a file called MyText and to use the editor 
  102.         commands located in the edit.prefs file (which you 
  103.         created earlier). The data will then be saved as 
  104.         YourText. And, to send all the messages and verifications 
  105.         from EDIT to your printer while setting the number of 
  106.         lines to 50 and a line width as 175:
  107.  
  108.         EDIT FROM MyText TO YourText WITH edit.prefs VER
  109.             PRT: OPT W175 OPT P50
  110.  
  111.  
  112.  
  113.         See also:
  114.  
  115.         STACK
  116.         
  117.